perm filename OUTPUT.TXT[TEX,DEK] blob sn#693410 filedate 1983-01-04 generic text, type C, neo UTF8
COMMENT āŠ—   VALID 00005 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	Output controls in plain TeX: a draft.
C00005 00003	* Here's an example of a nontrivial heading:
C00007 00004	* \topinsert stuff\endinsert puts the stuff at the top of the current page
C00009 00005	* \footnote{marker}{text of footnote} is intended to be used in
C00011 ENDMK
CāŠ—;
Output controls in plain TeX: a draft.

The following macros have been incorporated in the experimental version of TeX82
that now runs at SAIL, and I plan to describe them in the new manual. Please
feel free to test them, since that will help to get the bugs out; but please
don't be too upset if I change some of these features without notice
(except that I plan to keep this file uptodate). The features are not extensive;
they are simply intended to help people build more elaborate formats.

* \nopagenumbers will suppress the page numbers at the foot of each page.

* \headline and \footline are placed at the top and bottom of pages, in lines
of width \the\hsize. The default value of \headline is \hfil, and the default
value of \footline gives the page number, centered. For example, the
macro \nopagenumbers reduces to "\def\footline{\hfil}".

* \pagenumber prints the page number of the current page; this is an
abbreviation for "{\rm\number\count0}". The default setting of \footline is
"\hss\pagenumber\hss". The first page is usually number 1; to start
at a different page, e.g., 500, say \setcount0=500. To get roman numeral
page numbers, use negative numbers; for example, \setcount0=-1 will produce
pages numbered i, ii, iii, iv, v, vi, vii, viii, ix, and so on.
* Here's an example of a nontrivial heading:
\def\headline{\ifeven0\leftheadline\else\rightheadline\fi}
\def\leftheadline{\pagenumber\hfil \sc LEFT RUNNING HEAD}
\def\rightheadline{\sc RIGHT RUNNING HEAD\hfil\pagenumber}

(The left headline will go on even-numbered pages and the right headline
on odd-numbered pages. You probably should say \nopagenumbers when you
use this. "\sc" is a small-caps font; you should always specify a font for
everything in your headlines and footlines, since the current
font is unknown at the time an output routine becomes active.)

* \raggedbottom produces pages that have variable bottom margins
(analogous to \raggedright, which makes variable right margins).
* \topinsert stuff\endinsert puts the stuff at the top of the current page
or carries it over to the next page on which it will fit. The "stuff"
should be in vertical mode. For example, \topinsert\vskip 2in\endinsert leaves
room for a 2-inch illustration. An extra \bigskip of space is allowed
below that illustration. Here's another example:
	\topinsert\vskip2in
		\noindent{\bf Figure 4.} This is the caption for
		the fourth figure of my paper. It's a fairly long
		caption that won't fit on a single line, but that's OK.
	\endinsert

* \midinsert stuff\endinsert is like \topinsert except that the "stuff"
will go right in the middle of the current page (with \bigskip above and
below) if it fits; otherwise it will be placed at the top of the next
available page.

* \pageinsert stuff\endinsert is like \topinsert except that the "stuff"
is supposed to be an entire pagefull; \vbox to\the\vsize{stuff} will
go on the next available page, where it will appear all by itself.

* Don't use \topinsert or \midinsert or \pageinsert in the middle of a
paragraph; use them between paragraphs (i.e., in vertical mode).
* \footnote{marker}{text of footnote} is intended to be used in
paragraphs. For example,\footnote*{This footnote is attached
after the comma of `For example,'.} two footnotes are illustrated
in this sentence.\footnote{$↑\dagger$}{Here's a footnote that has
a superscript dagger as its marker.}

* Long footnotes will be split between pages, if necessary, and
continued at the bottom of the next page. (Don't use \pageinsert
on a page that has a split footnote, since they both will try
to get on that same next page!)

* \footnote should not be used in other places: For example, you can't have
footnotes inside footnotes, nor in the entries of an alignment, nor even
in a \ctrline. There is a kludgy way to get around this, in an
emergency, by putting the marker where you want it and then using
\vfootnote, in vertical mode, on the appropriate page:
	\ctrline{A paper by D. E. Knuth*}
	\vfootnote*{Supported by NSF.}
Note that the marker appears twice.

* \supereject will eject all remaining illustrations and footnotes.